Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Controlling Sequence Grabber Components

SGPause

You can suspend or restart a record or preview operation by calling the SGPause function. You supply a byte value that instructs the sequence grabber whether to pause or restart the current operation.

pascal ComponentResult SGPause (SeqGrabComponent s, 
                               Byte pause);

s

Specifies the component instance that identifies your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenDefaultComponent or OpenComponent function.

pause

Instructs the sequence grabber whether to suspend or restart the current operation. The following values are valid:

seqGrabUnpause

Restarts the current operation.

seqGrabPause

Pauses the current operation.

seqGrabPauseForMenu

Pauses the current operation so that you may display a menu. Use this option only in preview mode, just before you call the Menu Manager's MenuSelect or PopUpMenuSelect function. In this case, the sequence grabber may not pause all channels, depending upon the ability of the sequence grabber to play with acceptable quality. For example, sound channels may continue to play while video channels are paused.

DESCRIPTION

The SGPause function does not release any system resources or temporary memory associated with the current operation. Consequently, it is generally much faster than using the SGStop and SGStartRecord functions or the SGStartPreview function to suspend an operation.

SPECIAL CONSIDERATIONS

When you restart the operation, the sequence grabber component may be unable to satisfy your request. This can occur, for example, if the user has moved the display window to a location that the digitizing hardware cannot support.

RESULT CODES

cantDoThatInCurrentMode	-9402	Request invalid in current mode
notEnoughMemoryToGrab	-9403	Insufficient memory for record operation
deviceCantMeetRequest	-9408	Device cannot support grabber

File Manager errors
Memory Manager errors

SEE ALSO

You may determine whether the sequence grabber is paused by calling the SGGetPause function, which is described next.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help